Skip to content

Add Google Workspace connection documentation#36243

Merged
maddiefranke merged 9 commits intomasterfrom
maddie.franke/google-workspace-connection-doc
Apr 30, 2026
Merged

Add Google Workspace connection documentation#36243
maddiefranke merged 9 commits intomasterfrom
maddie.franke/google-workspace-connection-doc

Conversation

@maddiefranke
Copy link
Copy Markdown
Contributor

@maddiefranke maddiefranke commented Apr 23, 2026

Adds setup documentation for Google Workspace connections in Datadog Actions, covering OAuth2 client configuration in Google Cloud and connection creation in Datadog.

What does this PR do? What is the motivation?

Adds a new doc page at /actions/connections/google_workspace that walks users through:

  1. Creating a Google Cloud project
  2. Enabling the required Google Workspace APIs
  3. Configuring the OAuth consent screen and scopes
  4. Creating OAuth2 credentials, including both the Authorized JavaScript origins and Authorized redirect URIs from the Datadog connection dialog
  5. Creating the connection in Datadog

Also includes a full scopes reference table for Gmail, Calendar, Drive, Docs, Sheets, Forms, Chat, user identity, and Workspace Admin.

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

AI assistance

Used Claude Code for drafting and editing.

Additional notes

Covers OAuth2 setup, scope selection, and connection creation in Datadog
for Gmail, Calendar, Drive, Docs, Sheets, Forms, and Chat.
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 23, 2026

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@maddiefranke maddiefranke marked this pull request as ready for review April 23, 2026 21:09
@maddiefranke maddiefranke requested a review from a team as a code owner April 23, 2026 21:09
@iadjivon
Copy link
Copy Markdown
Contributor

Added a Jira card for editorial review: DOCS-14163

@iadjivon iadjivon added the editorial review Waiting on a more in-depth review label Apr 23, 2026
maddiefranke and others added 3 commits April 23, 2026 21:51
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Use the {{< ui >}}{{< /ui >}} shortcode for Datadog UI labels for consistency with other connection docs
- Renumber reference links sequentially (skipped [3] previously)
- Remove numerals from prerequisite subheadings to produce cleaner anchors
- Rephrase step 2 of "Enable the required APIs" so the table reads as part of the procedure
- Drop redundant "below" after in-page anchor links
- Replace "info" with "information" in the User identity scopes table
- Reword "Google Docs documents" and "Google Sheets spreadsheets" to remove noun stacking
Copy link
Copy Markdown
Contributor

@estherk15 estherk15 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @maddiefranke for adding this information! I left a few comments on the content. Also, created a separate PR for formatting fixes, if these look OK, you can merge to your branch: #36355

Comment thread content/en/actions/connections/google_workspace.md Outdated
Comment thread content/en/actions/connections/google_workspace.md Outdated
Comment thread content/en/actions/connections/google_workspace.md Outdated
Comment thread content/en/actions/connections/google_workspace.md Outdated
Comment thread content/en/actions/connections/google_workspace.md Outdated
estherk15 and others added 2 commits April 29, 2026 14:02
- Reword Prerequisites intro and replace inline Google Cloud project
  creation steps with a link to Google's own guide.
- Link "app verification" to Google's restricted-scope verification doc
  and clarify "authorize" -> "authorize the app".
- Combine the Authorized JavaScript origins and Authorized redirect URIs
  steps into a single instruction with a shared note.
- Reword the Authorize URL/Token URL step to "Leave [...] as their
  pre-populated default values".
- Renumber reference-style links in usage order and drop the
  now-unused Google Cloud Console root link.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Apr 30, 2026
@maddiefranke
Copy link
Copy Markdown
Contributor Author

Thanks @maddiefranke for adding this information! I left a few comments on the content. Also, created a separate PR for formatting fixes, if these look OK, you can merge to your branch: #36355

@estherk15 Thanks for the review :) I've merged your branch in and updated with your other suggestions - super helpful!!

Copy link
Copy Markdown
Contributor

@estherk15 estherk15 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates and for your work on this!

@maddiefranke maddiefranke merged commit 81f865c into master Apr 30, 2026
14 of 15 checks passed
@maddiefranke maddiefranke deleted the maddie.franke/google-workspace-connection-doc branch April 30, 2026 20:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants